From: Eli Zaretskii <eliz@gnu.org>
Date: Tue, 29 Apr 2025 08:19:19 +0000 (+0300)
Subject: ; Improve documentation of 'format-time-string'
X-Git-Tag: archive/raspbian/1%30.2+1-2+rpi1^2~2^2~24^2~116
X-Git-Url: https://dgit.raspbian.org/%22http://www.example.com/cgi/%22/%22http:/www.example.com/cgi/%22?a=commitdiff_plain;h=79e7eeb32964ba79f0d0ef06c9c0d7c16c542f37;p=emacs.git

; Improve documentation of 'format-time-string'

* doc/lispref/os.texi (Time Parsing): Fix documentation of week
numbers for %U, %V and %W.  (Bug#78096)
---

diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
index 3f2388daeb3..0e9e3982ec5 100644
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -1938,14 +1938,18 @@ This is a synonym for @samp{%H:%M:%S}.
 This stands for the numeric day of week (1--7).  Monday is day 1.
 @item %U
 This stands for the week of the year (01--52), assuming that weeks
-start on Sunday.
+start on Sunday.  If January 1 is not a Sunday, the first partial week
+is week zero.
 @item %V
-This stands for the week of the year according to ISO 8601.
+This stands for the week of the year according to ISO 8601.  Note that,
+unlike @samp{%U} and @samp{%W}, the week according to ISO 8601 does
+@emph{not} roll over to 1 on January 1, but keeps its last number.
 @item %w
 This stands for the numeric day of week (0--6).  Sunday is day 0.
 @item %W
-This stands for the week of the year (01--52), assuming that weeks
-start on Monday.
+This stands for the week of the year (01--52), assuming that weeks start
+on Monday.  If January 1 is not a Monday, the first partial week is week
+zero.
 @item %x
 This has a locale-specific meaning.  In the default locale (named
 @samp{C}), it is equivalent to @samp{%D}.